BBS in a Box 15/BBS in a box XV-1.iso/CD Setup/Hermes/Hermes II v3.2.1/Quickstart Docs.dp/Quickstart Docs.dp

Common Ground | 1995-01-28 | 53.4 KB | 335 lines | [APPL/CGSL]

(CGDC
Geneva
    Helvetica
    Hermes II
Version 3.2.1
 Macintosh
 Bulletin Board System
Computer Classifieds
12819 SE 38th #101
Bellevue, WA 98006
206-643-2316 (voice)
206-643-7830 (fax)
206-643-2874 (BBS)
LloydW (America Online)
"[e-mail] (Internet)
[e-mail] (Internet)
%Hermes II Programmer -  David Woodall
Documentation by Lloyd Woodall
$`Hermes II is
1989-1994 by Computer Classifieds.  All rights reserved.  Macintosh is a trademark
 licensed to Apple Computer, Inc.
iEven though Computer Classifieds. (
) has reviewed the documentation and tested the software, CC makes
eno warranty or representation, either express or implied, with respect to this software, its quality,
operformance, merchantability, or fitness for a particular purpose.  As a result, this software is sold
as is,
oand you, the purchaser, are assuming the entire risk as to its quality and performance.  In no event will CC be
kliable for direct, indirect, special, incidental, or consequential damages resulting from any defect in the
lsoftware or documentation. In particular, CC shall have no liability for any damage to programs or data used
nwith CC products including the costs of recovering such programs or data.  The warranty and remedies set forth
labove are exclusive and in lieu of all others, oral or written, express or implied.  No CC dealer, agent, or
nemployee is authorized to make any modification, extension, or addition to this warranty.  This warranty gives
`you specific legal rights, and you may have additional rights that may vary from state to state.
oThis archive contains copyrighted materials.  It can be re-distributed only in it's unmodified state as created
jby Computer Classifieds.  When a newer version is released, this archive must be removed from other online
systems.
Geneva
    Helvetica
Registration
 Information
Hermes II is distributed as
keyware
)0D.  Keyware is a system where you, the user, can use Hermes II for 30
$mdays without registering the application and entering your unique serial number.  After this trial period, if
lyou  want to use it, you must send in the registration fee.  When you register, you will receive access to a
mserial number that allows you to use the product further.  If you attempt to use the product beyond the trial
kperiod without a serial number, the software will not function.  Your thirty days starts the first time you
gboot any version of the program.  There are several ways to register.  The first is to simply log on to
fOlympus, the Hermes II Support BBS, and  register with your Master Card or Visa.  Master Card and Visa
apurchases are normally processed within 48 hours after entry.  You may also send a money order or
lcashier
s check. They are processed immediately.  The last option is to send a personal check, but  allow up
jto 10 days for this to clear after receipt.  You will be notified on the support BBS that we have received
Wyour personal check.   Your serial number must be obtained from the Hermes Support BBS.
keyware fee
)E1 is $125.00 for a license to operate Hermes II.
This license is
$7sold to the original purchaser and is not transferable.
  The program will cease to
$Pallow users to log on after 30 days  without a serial number.  To register, call
HOlympus, the Hermes II support BBS and register online with your Visa or
EMaster Card, or send a money order/cashier
s check/personal check to:
Computer Classifieds
12819 SE 38th #101
Bellevue, WA 98006
$SIf your check is not drawn in US Funds on a US Bank, it can
t be accepted.  Foreign
Rbanks will be able to produce such checks upon request.  You should print the form
Wat the end of this manual and send it in with your registration fee unless you register
Olympus
, the
Hermes II Support BBS
$2You can reach Olympus BBS at the following number:
[phone]
71200, 2400, HST, V.32, V.32bis., V.32terbo, VFAST, V.34
$lIt is wise to get on the support BBS listed above.  It provides an invaluable source of information exchange
iand Hermes II support.  There are hundreds of users there exchanging advice on how to get the most out of
dHermes II.  All sysops will benefit from this BBS, and you can always download latest version there.
kUnregistered users may establish an account on this BBS for 30 days.  If they do not register by that time,
itheir account will be deleted.  Unregistered accounts have restricted access, but may download the latest
kversions for as long as their account exists.  Access to serial numbers is managed through the support BBS;
Yalthough, full access there is not related to registration and is not officially part of
registration
.   As a
$Aregistered user you will be able to get your serial number there.
iObviously, every customer has a modem, so there should be no problem in obtaining the latest version from
iOlympus.  Hermes II is updated too often to send out new versions by mail.  However, if you are a foreign
hcustomer or have some other special case where you are unable to log on to the support BBS, we will make
jexceptions.  If you send a formatted disk with a self addressed stamped envelope, it will be returned with
jthe latest version of the program and manual.  You must either register simultaneously or be registered to
jdo this.  Serial numbers cannot be sent through the mail.  Without exception, they must be obtained on the
support BBS.
Geneva
    Helvetica
Hardware Requirements
iHermes II will run on the Macintosh Plus and above. It runs quite nicely on the Power Macs as well.   You
gwill need a modem that is Hayes AT-command set compatible, and, of course, a phone line.  Modem drivers
dare provided for standard 2400 baud modems, as well as a number of high speed modems.  If you have a
lmodem that is incompatible with all of these drivers, please contact the support board.  If your modem is at
iall common, you will probably be able to download a driver from the support BBS.   A special modem driver
hdialog in Hermes II makes writing your own driver a comparatively easy process.  It is imperative that a
breliable, high-quality modem is used in BBS operations.  Problems with "off brand" or poor quality
kmodems includes the lack of available modem drivers, degraded connections and loss of carrier.  It has been
bour experience that poor modems cause the greatest problem area in setting up and operating a BBS.
aComputer Classifieds sells USR Sportster v.32bis (14400 baud) modems at attractive prices.  These
4modems will provide reliable service with Hermes II.
Standard Macintosh
modem cables
)N. are not designed for BBS use. You will need a
$Ocustom Hermes II BBS cable in order for the BBS to both detect carrier loss and
manage flow control.
NBBS operations are different from just calling with communications software in
$jthat the BBS must not only handle flow control, but ALSO monitor carrier state to detect whether the phone
jline (the caller) is still connected.  This is required so that if a user is disconnected without properly
Flogging off, your system will recognize this and reset.  Without this
custom Hermes II BBS cable
, your BBS
$lwill not reset properly if a user is disconnected without logging off the BBS.  Users disconnected while NOT
mtransferring will eventually be logged off by the inactivity timeout and the node will reset, but if the user
cwas transferring, your BBS may never reset until done manually.  Custom Hermes II BBS cables can be
Lordered from Computer Classifieds for $20 (select the Hermes Mall external).
hSome Macintosh models use a custom Apple chip (the Apple Combo Chip) for serial communication functions.
kThe chip combines the functions of the 8550 (SCC) and the 53C80/53C96 (SCSI) into a single chip.  This chip
doesn't have
F capabilities, so the computers that use it have no GPI functionality.
$"The Macintosh models affected are:
 Classic, Classic II, Color Classic
 Macintosh LC, LC II, LC III,
 Performa 200, 400, 405, 430, 450, 600
 Macintosh IIvx, IIvi
 The Mac Plus and older also do not GPI capability as this was never designed into these older computers.
+You cannot successfully use Cable ID#3 and
RTS/CTS flow control
)i) with these computers and Hermes II.  You
$jshould use Cable ID#1 and XON/XOFF flow control if you use these models. (You can use RTS/CTS flow control
4with these computers in non-BBS operations) however.
eTo use RTS/CTS flow control you must use Cable ID#3.  This requires GPI (pin 7) support.  Operational
jtests have shown that XON/XOFF flow control is as fast and reliable as RTS/CTS flow control.  In addition,
(Cable ID#1 that Hermes II requires with
     XON/XOFF
)45 (or no flow control) allows for a much quicker reset
$Lof the BBS when a user logs off.  This is preferred with multi-line systems.
Geneva
    Helvetica
Software Requirements
aIt is recommended that you use System 7.0 or newer, but Hermes will run on System 6.0.4 or newer.
dHermes runs well with System 7.5 also.  If you use System 6, you must install the Mac Communications
hToolbox.  You can obtain this from the support board, APDA, and most online services such as CompuServe,
jAmerica Online, GEnie or Prodigy.  If you want to set up an Appletalk (or Ethernet) node, you will need to
install the
)5    Appletalk
    ADSP Tool
)1G (an Extension) and any transfer protocol tools (X modem or Z modem) on
$gboth the BBS and calling computers.  The calling computer's communication application must also support
ADSP.
Quick Setup
**<You must read and follow these instructions or your BBS will
not function properly!
pThis text is designed to give an experienced user a quick overview to get the BBS online as quickly as possible.
If you use the
Quick Setup
)9Q section to first start up your BBS, you should later read full documentation for
$oadditional information so you can better understand the workings of the software.  While it is not difficult to
oset up a Hermes II BBS, the software does allow many variations and you will get the most out of your system if
/you do print the docs and read them thoroughly.
^For proper file "pathing"  name your hard drive "Macintosh HD" and you should leave the Hermes
$$application in the folder named "BBS
F".  Put the BBS folder at the top level of your hard drive (not on the
$qdesktop but on first level of the hard drive).  If either the hard drive or folder with the BBS application has a
$different name, you must reset the "
Files Path
)1>" for each file transfer directory as well as the paths in the
$GSystem Preferences menu.  Refer to items #4 and #10 to reset the paths.
$2.  Decompress and launch Hermes II.
o3.  When the application asks you to locate the System Prefs file or select "New", select New to create all the
lfiles needed for a new BBS.  Hermes II will automatically create the ANSI color and B & W menus, text menus,
pFile Transfer sections, Message sections, and several Security Levels.  You can change these although it is best
`to leave them at their default settings as the entire BBS has been set up based on these values.
4. Select the
System Preferences
)aI menu (under Setup) to review and change any settings.  Click on the "Use
$oAliases" box only if you want to allow users to log on using "handles" rather than real names.  If your Mac CPU
lhas no color capability, select "Display Intense as BOLD".  If you don't have your hard drive and BBS folder
knamed as shown in Item #1 above, click on the buttons to set the "Data Folder", "Message Folder" and "GFile
lFolder" paths.  You must reset the paths to the Data, Message, and GFile folders.  If you want to allow file
lattachments to E-Mail leave the "Allow Mail Attachments" box checked.  If you don't have your hard drive and
kBBS folder named as shown in #1 above, click on the "Directory Setup" box to set the path to the folder you
*want to hold the files attached to E-Mail.
i5.  Select the New User menu (under Setup).  Check the boxes for the information you want to solicit from
Fyour users.  Hermes will only ask for the information that you select.
c6.  Select "Local Logon" under the Sysop menu to log on the system and set up your (Sysop) account.
07.  Answer the new user information and log off.
Geneva
$X8.  Select the User Edit menu (under Sysop), double click on your name, and change your
Security Level
$hClassification from New User to Sysop from the pull down menu. Also check the Sysop box to give you full
Sysop access.
9. Set up your Message Section.
-a.  Select the "Messages" menu (under Setup).
Ub.  Double Click on "Forum #1" from the list and rename Forum 1 to whatever you wish.
5c.  From the  pull-down "Area" menu, select Forum #1.
kd.  Double click on the Message Subs and name all your message subs.  15 message subs are automatically set
lup; all you need to do is enter a name for each message sub.  You can create up to 30 message subs per forum
gand can create up to 10 forums if desired.  The security levels are already set, but you can change any
attributes that you wish.
!10. Set up your Transfer Section.
,a.  Select the Transfers menu (under Setup).
Jb.  Double click on the "Area #1" and enter a new name for it if you wish.
/c.  Select, then double click on "Directoriy1".
+d.  Rename Directory1 to whatever you wish.
[e.  Change any settings in Directory1 as you wish.  In all of the transfer directories the
Download Security
Levels
i have been pre-set, but you can change any attributes that you wish.  Refer to the Transfer setup section
$ifor a detailed guide in setting up your transfer section as well as the default Download Security Levels.
IMPORTANT NOTE -
)tSIf your hard drive or BBS folder name is not as outlined above in Item #1, you must
$tclick on the "Set Path" button and reset the "Files Path" to the folder that will hold the files for that directory.
qIf the path is not set, then the transfer directory will show zero kilobytes of space available when users try to
kupload, and if you attempt to upload from the File Manager you will get error -120 as the BBS does not know
;where to send uploaded files.  Click on "OK" when finished.
Mf.  Change the remainder of the directories just like you did for Directory1.
nHermes II automatically creates a Sysop area with 2 directories and Area #1 with 15 directories.  All you need
sto do is rename Area #1 and the directories in it.    You can create a total of 65 areas, each with 64 directories.
qThe first  area (Sysop) is a "Sysops Only" area.  Files uploaded to the Sysop will be sent to the "Sysop Uploads"
sdirectory.  Area #1 is the first area that is used for general BBS callers.   If you create additional directories,
lyou must make a folder for each and set the "Files Path" for each Directory to the folder you created.  Just
lremember that you must always have the correct "files path" set to tell the BBS where to put uploaded files,
Uand that this is done by clicking on the "Set Path" box in each "Directory Set" menu.
a11.  Select Node #1 (under Sysop), then Node Prefs (under Setup) and configure Node 1 as follows:
6a.  Select the serial port your modem is hooked up to.
4b.  Select the modem driver for your specific modem.
Wc.  Configure the modem control settings from the following 3 basic "classes" of setup.

2400 baud Modem
High Speed Modem
High Speed Modem

with no
with XON/XOFF
with RTS/CTS

flow control
flow control
low control
Max Baud:
2400
19200 or higher
19200 or higher
Min Baud:
1200
1200
Modem Driver:
Generic 2400
Your modem model
Your modem model
Off Hook:
Checked
Checked
Checked
Change Speed:
Checked
NOT Checked
NOT Checked
DTR Hangup:
Checked
Checked
NOT Checked
Carrier Detect:
CTS Pin 5
CTS Pin 5
DCD Pin 7/Chip
Hardware Handshake:
NOT Checked
NOT Checked
Checked
Serial Port:
Modem
Modem
Modem
Geneva
$pd.  Click on "OK" to save your settings and initialize the modem.  The node should now show "Waiting...".  If it
ndoes not, a setting is incorrect and you should refer to the full documentation and review all your Node Prefs
lsettings.  Proper modem setup accounts for most startup problems, but once you get the node properly set you
should have reliable operation.
iFor high speed modems, first set your Max Baud speed to 19200.  Once proper operation is assured, set Max
jBaud to the highest functional speed (some modems will not work reliably at 57600).  If your modem type is
onot in the default list, call Olympus, the Hermes II support BBS and download the driver you need.  If a driver
mfor your modem is not available,  you will have to write a driver for it.  A generic 144/288 modem driver has
kbeen included that may work with some unlisted modems.  In any event it should serve as a starting place to
pwrite your own high speed modem driver.  Look in Appendix B of the docs for a detailed text file on how to write
ia modem driver.  You will also need to buy or make the custom Hermes II BBS modem cable.  Without it your
qBBS will not be able to detect carrier loss, and if a user disconnects without properly logging off, the BBS will
knot reset properly in order to accept any incoming calls.  This cable can be purchased from the Support BBS
cfor $20 (select the Hermes Mall external to order). Use Cable ID#1 for XON/XOFF, and Cable ID#3 for
dRTS/CTS flow control.  All Macs support Cable ID#1 but the following Macs do not support Cable ID#3:
"Classic, Classic II, Color Classic
Macintosh LC, LC II, LC III,
%Performa 200, 400, 405, 430, 450, 600
Macintosh IIvx, IIvi
Mac Plus
m12.  You are now ready to receive calls.  You should have a friend call your system to insure that people can
connect and transfer files.
c13.  PRINT THE DOCUMENTATION for reference.  Detailed setup instructions, tips on BBS operation and
0troubleshooting information there will help you.
c14.  Call the Hermes II support BBS at [phone] to register your copy and receive your serial
jnumber well before the 30 day limit so your BBS will not be "down" while registration is in progress.  The
eregistration fee is $125 and you can register online with your Visa or Master card. Type a period and
eselect the Hermes II registration external.  Hundreds of external applications are available once you
    register.
|Jx(`
/7=P@8.;:2L6O
&',-*
p     P8
/7=P@8.;:2L6O
&',-*
FNWincdev
NWincdev
    temp.0001
(NWinpref
NWinpref
NWinpref
NWinpref
NWinpref
NvDaAPPL
Lloyd Woodall
Computer Classifieds
Microsoft Word

Geneva
    Helvetica
jPREC
vPRVS